Skip to main content
POST
/
api
/
portrait
/
analysis
/
skin-analysis-pro
Skin analyze Pro
curl --request POST \
  --url https://www.ailabapi.com/api/portrait/analysis/skin-analysis-pro \
  --header 'Content-Type: multipart/form-data' \
  --header 'ailabapi-api-key: <api-key>' \
  --form 'return_maps=<string>' \
  --form 'return_marks=<string>' \
  --form 'roi_outline_color=<string>' \
  --form 'return_side_results=<string>' \
  --form image=@example-file \
  --form left_side_image=@example-file \
  --form right_side_image=@example-file
{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_code_str": "",
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "face_rectangle": {
    "top": 0,
    "left": 0,
    "width": 0,
    "height": 0
  },
  "left_side_result": {
    "left_jawline_quality": 1,
    "left_jawline_angle": 122.73,
    "left_jawline_mark": [
      {
        "x": 518,
        "y": 1256
      },
      {
        "x": 531,
        "y": 1260
      }
    ]
  },
  "right_jawline_info": {
    "right_jawline_quality": 1,
    "right_jawline_angle": 122.73,
    "right_jawline_mark": [
      {
        "x": 518,
        "y": 1256
      },
      {
        "x": 531,
        "y": 1260
      }
    ]
  },
  "result": {
    "image_quality": {
      "face_ratio:": 0.3,
      "face_orientation": {
        "yaw": 30.1,
        "pitch": 21.2,
        "roll": 89
      },
      "face_rect": {
        "top": 808,
        "left": 677,
        "width": 800,
        "height": 800
      },
      "hair_occlusion": 0.05,
      "glasses": 0
    },
    "skin_type": {
      "skin_type": 0,
      "details": {
        "0": {
          "value": 0,
          "confidence": 0.89
        },
        "1": {
          "value": 0,
          "confidence": 0.89
        },
        "2": {
          "value": 1,
          "confidence": 0.89
        },
        "3": {
          "value": 0,
          "confidence": 0.89
        }
      }
    },
    "oily_intensity": {
      "t_zone": {
        "area": 0,
        "intensity": 0
      },
      "left_cheek": {
        "area": 0,
        "intensity": 0
      },
      "right_cheek": {
        "area": 0,
        "intensity": 0
      },
      "chin_area": {
        "area": 0,
        "intensity": 0
      }
    },
    "water": {
      "water_severity": 0,
      "water_area": 0,
      "water_forehead": {
        "area": 0
      },
      "water_leftcheek": {
        "area": 0
      },
      "water_rightcheek": {
        "area": 0
      }
    },
    "skin_tone": {
      "value": 0,
      "confidence": 0
    },
    "skintone_ita": {
      "ITA": 0,
      "skintone": 0
    },
    "skin_hue_ha": {
      "HA": 0,
      "skin_hue": 0
    },
    "blackhead": {
      "value": 0,
      "confidence": 0
    },
    "blackhead_count": 0,
    "enlarged_pore_count": {
      "forehead": {
        "count": 0,
        "area": 0
      },
      "left_cheek_count": {
        "count": 0,
        "area": 0
      },
      "right_cheek_count": {
        "count": 0,
        "area": 0
      },
      "chin_count": {
        "count": 0,
        "area": 0
      }
    },
    "pores_forehead": {
      "value": 0,
      "confidence": 0
    },
    "pores_rightcheek": {
      "value": 0,
      "confidence": 0
    },
    "pores_leftcheek": {
      "value": 0,
      "confidence": 0
    },
    "pores_jaw": {
      "value": 0,
      "confidence": 0
    },
    "rough": {
      "rough_severity": 0,
      "rough_area": 0,
      "rough_forehead": {
        "area": 0
      },
      "rough_leftcheek": {
        "area": 0
      },
      "rough_rightcheek": {
        "area": 0
      },
      "rough_jaw": {
        "area": 0
      }
    },
    "melanin": {
      "brown_area": 0,
      "melanin_concentration": 0,
      "brown_forehead": 0,
      "brown_leftcheek": 0,
      "brown_rightcheek": 0
    },
    "melanin_mark": {
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "mole": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "brown_spot": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "melasma": {
      "value": 0,
      "confidence": 0
    },
    "freckle": {
      "value": 0,
      "confidence": 0
    },
    "acne": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "acne_pustule": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "acne_nodule": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "acne_mark": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "closed_comedones": {
      "rectangle": [
        {
          "width": 0,
          "top": 0,
          "height": 0,
          "left": 0
        }
      ],
      "confidence": [
        0
      ],
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "sensitivity": {
      "sensitivity_area": 0,
      "sensitivity_intensity": 0
    },
    "sensitivity_mark": {
      "polygon": [
        [
          {
            "x": 0,
            "y": 0
          }
        ]
      ]
    },
    "skin_age": {
      "value": 0
    },
    "forehead_wrinkle": {
      "value": 0,
      "confidence": 0
    },
    "crows_feet": {
      "value": 0,
      "confidence": 0
    },
    "eye_finelines": {
      "value": 0,
      "confidence": 0
    },
    "glabella_wrinkle": {
      "value": 0,
      "confidence": 0
    },
    "nasolabial_fold": {
      "value": 0,
      "confidence": 0
    },
    "nasolabial_fold_severity": {
      "value": 0,
      "confidence": 0
    },
    "left_mouth_wrinkle_severity": {
      "value": 0
    },
    "right_mouth_wrinkle_severity": {
      "value": 0
    },
    "forehead_wrinkle_severity": {
      "value": 0
    },
    "left_crows_feet_severity": {
      "value": 0
    },
    "right_crows_feet_severity": {
      "value": 0
    },
    "left_eye_finelines_severity": {
      "value": 0
    },
    "right_eye_finelines_severity": {
      "value": 0
    },
    "glabella_wrinkle_severity": {
      "value": 0
    },
    "left_nasolabial_fold_severity": {
      "value": 0
    },
    "right_nasolabial_fold_severity": {
      "value": 0
    },
    "left_cheek_wrinkle_severity": {
      "value": 0
    },
    "right_cheek_wrinkle_severity": {
      "value": 0
    },
    "fine_line": {
      "forehead_count": 0,
      "left_undereye_count": 0,
      "right_undereye_count": 0,
      "left_cheek_count": 0,
      "right_cheek_count": 0,
      "left_crowsfeet_count": 0,
      "right_crowsfeet_count": 0,
      "glabella_count": 0
    },
    "wrinkle_count": {
      "forehead_count": 0,
      "left_undereye_count": 0,
      "right_undereye_count": 0,
      "left_mouth_count": 0,
      "right_mouth_count": 0,
      "left_nasolabial_count": 0,
      "right_nasolabial_count": 0,
      "glabella_count": 0,
      "left_cheek_count": 0,
      "right_cheek_count": 0,
      "left_crowsfeet_count": 0,
      "right_crowsfeet_count": 0
    },
    "forehead_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "forehead_wrinkle_list": []
    },
    "left_eye_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "left_eye_wrinkle_list": []
    },
    "right_eye_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "right_eye_wrinkle_list": []
    },
    "left_crowsfeet_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "left_crowsfeet_wrinkle_list": []
    },
    "right_crowsfeet_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "right_crowsfeet_wrinkle_list": []
    },
    "glabella_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "glabella_wrinkle_list": []
    },
    "left_mouth_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "left_mouth_wrinkle_list": []
    },
    "right_mouth_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "right_mouth_wrinkle_list": []
    },
    "left_nasolabial_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "left_nasolabial_wrinkle_list": []
    },
    "right_nasolabial_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "right_nasolabial_wrinkle_list": []
    },
    "left_cheek_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "left_cheek_wrinkle_list": []
    },
    "right_cheek_wrinkle_info": {
      "wrinkle_score": 0,
      "wrinkle_severity_level": 0,
      "wrinkle_norm_length": 0,
      "wrinkle_norm_depth": 0,
      "wrinkle_pixel_density": 0,
      "wrinkle_area_ratio": 0,
      "wrinkle_deep_ratio": 0,
      "wrinkle_deep_num": 0,
      "wrinkle_shallow_num": 0,
      "right_cheek_wrinkle_list": []
    },
    "cheekbone_mark": {
      "left_cheekbone_mark": [],
      "right_cheekbone_mark": []
    },
    "eye_pouch": {
      "value": 0,
      "confidence": 0
    },
    "eye_pouch_severity": {
      "value": 0,
      "confidence": 0
    },
    "left_eye_pouch_rectangle": [],
    "right_eye_pouch_rectangle": [],
    "dark_circle": {
      "value": 0,
      "confidence": 0
    },
    "dark_circle_severity": {
      "value": 0,
      "confidence": 0
    },
    "left_dark_circle_rete": {
      "value": 0
    },
    "right_dark_circle_rete": {
      "value": 0
    },
    "left_dark_circle_pigment": {
      "value": 0
    },
    "right_dark_circle_pigment": {
      "value": 0
    },
    "left_dark_circle_structural": {
      "value": 0
    },
    "right_dark_circle_structural": {
      "value": 0
    },
    "dark_circle_mark": {
      "left_eye_rect": {
        "left": 0,
        "top": 0,
        "width": 0,
        "height": 0
      },
      "right_eye_rect": {
        "left": 0,
        "top": 0,
        "width": 0,
        "height": 0
      }
    },
    "left_eye_pouch_rect": {
      "left": 0,
      "top": 0,
      "width": 0,
      "height": 0
    },
    "right_eye_pouch_rect": {
      "left": 0,
      "top": 0,
      "width": 0,
      "height": 0
    },
    "wrinkle_mark": {
      "left_cheek_wrinkle_outline": [],
      "right_cheek_wrinkle_outline": [],
      "head_wrinkle_outline": [],
      "left_nasolabial_wrinkle_outline": [],
      "right_nasolabial_wrinkle_outline": [],
      "glabella_wrinkle_outline": [],
      "left_crowsfeet_wrinkle_outline": [],
      "right_crowsfeet_wrinkle_outline": [],
      "left_mouth_wrinkle_outline": [],
      "right_mouth_wrinkle_outline": [],
      "left_eye_wrinkle_outline": [],
      "right_eye_wrinkle_outline": []
    },
    "dark_circle_outline": {
      "left_dark_circle_outline": [],
      "right_dark_circle_outline": []
    },
    "score_info": {
      "dark_circle_score": 0,
      "skin_type_score": 0,
      "wrinkle_score": 0,
      "oily_intensity_score": 0,
      "pores_score": 0,
      "blackhead_score": 0,
      "acne_score": 0,
      "sensitivity_score": 0,
      "melanin_score": 0,
      "water_score": 0,
      "rough_score": 0,
      "total_score": 0,
      "pores_type_score": {
        "pores_forehead_score": 0,
        "pores_leftcheek_score": 0,
        "pores_rightcheek_score": 0,
        "pores_jaw_score": 0
      },
      "dark_circle_type_score": {
        "left_dark_circle_score": 0,
        "right_dark_circle_score": 0
      }
    },
    "enhanced_bw_info": {
      "enhanced_bw_rect": {
        "left": 0,
        "top": 0,
        "width": 0,
        "height": 0
      },
      "ratio": 0
    },
    "face_maps": {
      "red_area": "",
      "brown_area": "",
      "texture_enhanced_pores": "",
      "texture_enhanced_blackheads": "",
      "texture_enhanced_oily_area": "",
      "texture_enhanced_lines": "",
      "water_area": "",
      "rough_area": "",
      "roi_outline_map": "",
      "texture_enhanced_bw": ""
    }
  }
}

Authorizations

​
ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
​
image
file

Main Image.

​
left_side_image
file

Side face picture.(Left)

​
right_side_image
file

Side face picture.(Right)

​
return_maps
string

The type of skin problem detection mapping image to be returned. If the corresponding element parameter is passed in, the interface will return an image of the original size, which you can subsequently overlay with the original image to see the results. Use commas to separate multiple types.

​
return_marks
string

The type of skin problem detection mapping image to be returned. Use commas to separate multiple types.

​
roi_outline_color
string

Customize the color.

​
return_side_results
string

The side face information that needs to be returned. Use commas to separate multiple types.

Response

200 - application/json

Success

The response is of type object.